HAL PSSI functions IRQ handler and callbacks migration

This section provides information about the HAL PSSI functions IRQ handler and callbacks migration.

Note

The callback names are the same between HAL1 and HAL2.

HAL PSSI callbacks functions

Title

HAL1

HAL2

Transmit complete Callback 

void HAL_PSSI_TxCpltCallback(PSSI_HandleTypeDef *hpssi);

void HAL_PSSI_TxCpltCallback(hal_pssi_handle_t *hpssi);

Receive complete Callback 

void HAL_PSSI_RxCpltCallback(PSSI_HandleTypeDef *hpssi);

void HAL_PSSI_RxCpltCallback(hal_pssi_handle_t *hpssi);

Abort complete Callback 

void HAL_PSSI_AbortCpltCallback(PSSI_HandleTypeDef *hpssi);

void HAL_PSSI_AbortCpltCallback(hal_pssi_handle_t *hpssi);

Error Callback 

void HAL_PSSI_ErrorCallback(PSSI_HandleTypeDef *hpssi);

void HAL_PSSI_ErrorCallback(hal_pssi_handle_t *hpssi);

HAL PSSI register callback

In HAL1, the function HAL_PSSI_RegisterCallback is used to register various PSSI callbacks through a single function with a specific callback ID. In HAL2, distinct functions are available to register each specific PSSI callback, providing more granularity and control over the callback registration process.

HAL1

HAL2

PSSI TX complete callback 

HAL_PSSI_RegisterCallback(&hpssi,
      HAL_PSSI_TX_COMPLETE_CB_ID,
       USER_PSSI_TxCpltCallback);

HAL_PSSI_RegisterTxCpltCallback(&hpssi,
             USER_PSSI_TxCpltCallback);

PSSI RX complete callback 

HAL_PSSI_RegisterCallback(&hpssi,
      HAL_PSSI_RX_COMPLETE_CB_ID,
       USER_PSSI_RxCpltCallback);

HAL_PSSI_RegisterRxCpltCallback(&hpssi,
              USER_PSSI_RxCpltCallback);

PSSI abort callback 

HAL_PSSI_RegisterCallback(&hpssi,
    HAL_PSSI_ABORT_CB_ID,
    USER_PSSI_AbortCpltCallback);

HAL_PSSI_RegisterAbortCpltCallback(&hpssi,
              USER_PSSI_AbortCpltCallback);

PSSI ERROR callback 

HAL_PSSI_RegisterCallback(&hpssi,
        HAL_PSSI_ERROR_CB_ID,
        USER_PSSI_ErrorCallback);

HAL_PSSI_RegisterErrorCallback(&hpssi,
              USER_PSSI_ErrorCallback);

PSSI Msp Init Callback 

HAL_PSSI_RegisterCallback(&pssi,
      HAL_PSSI_MSPINIT_CB_ID,
      USER_PSSI_MspInitCallback);

Removed / Sequence changed

PSSI Msp DeInit Callback 

HAL_PSSI_RegisterCallback(&pssi,
   HAL_PSSI_MSPDEINIT_CB_ID,
   USER_PSSI_MspDeInitCallback);

Removed / Sequence changed

Related concept Individual callback registration APIs replace global register and unregister functions

HAL PSSI unregister callback

In HAL2, the unregister callback API has been removed. Instead, callbacks can be managed by re-registering the default HAL PSSI weak callbacks as needed.

HAL 1

HAL 2

PSSI TX complete callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
       HAL_PSSI_TX_COMPLETE_CB_ID);

HAL_PSSI_RegisterTxCpltCallback(&hpssi,
              HAL_PSSI_TxCpltCallback);

PSSI RX complete callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
       HAL_PSSI_RX_COMPLETE_CB_ID);

HAL_PSSI_RegisterRxCpltCallback(&hpssi,
              HAL_PSSI_RxCpltCallback);

PSSI abort callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
             HAL_PSSI_ABORT_CB_ID);

HAL_PSSI_RegisterErrorCallback(&hpssi,
          HAL_PSSI_AbortCpltCallback);

PSSI ERROR callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
             HAL_PSSI_ERROR_CB_ID);

HAL_PSSI_RegisterAbortCpltCallback(&hpssi,
                  HAL_PSSI_ErrorCallback);

PSSI Msp Init Callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
           HAL_PSSI_MSPINIT_CB_ID);

Removed / Sequence changed

PSSI Msp DeInit Callback 

HAL_PSSI_UnRegisterCallback(&hpssi,
         HAL_PSSI_MSPDEINIT_CB_ID);

Removed / Sequence changed

Related concept Individual callback registration APIs replace global register and unregister functions

HAL PSSI IRQHandler

HAL1

HAL2 

HAL_PSSI_IRQHandler(PSSI_HandleTypeDef *hpssi);

HAL_PSSI_IRQHandler(hal_pssi_handle_t *hpssi);